home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 19 / CU Amiga Magazine's Super CD-ROM 19 (1998)(EMAP Images)(GB)[!][issue 1998-02].iso / CUCD / Utilities / Birdie / birdie.readme < prev   
Text File  |  1997-11-23  |  11KB  |  322 lines
  1. <HTML>
  2. <HEAD>
  3.    <TITLE>Birdie</TITLE>
  4.    <META NAME="description" CONTENT="Home page for the MakeCGXBootPic utility. An amazing program to create boot pictures for CGX v3">
  5.    <META NAME="keywords" CONTENT="CGX,CyberGraphX,MakeCGXBootPic,Jacob,LCi,JAAK3">
  6. </HEAD>
  7. <BODY TEXT="#000000" BGCOLOR="#C0C0C0" LINK="#0000EE" VLINK="#551A8B" ALINK="#FF0000" BACKGROUND="HTTP://www.vgr.com/cybergfx/nasa.gif">
  8. <IMG SRC="HTTP://www.vgr.com/cybergfx/bancgx.gif" WIDTH=185 HEIGHT=43 ALT="CGX">
  9. <HR>
  10. NOTE: The Birdie utility is NOT by the CGX Authors and is not directly supported by the CGX Webpage team. 
  11.       He is to lazy to do this page or to make docs for his program so blame him. :) - Robert
  12. <HR>
  13. <H2><B>What is Birdie?</B></H2><BR>
  14. <CENTER>
  15. Birdie is 'a dirty hack that gives patterns in window borders for cgx 3 users'.<BR>
  16. 'It's really really cool, unless it crashes you. It's a real life software lottery .. is it stable for you?'<BR>
  17. <A href="http://www.vgr.com/birdie/BirdieGrab.jpeg">
  18. <IMG SRC="HTTP://www.vgr.com/birdie/BirdieGrabMini.jpeg" WIDTH=200 HEIGHT=150 ALT="Snap On Drugs">
  19. </A><BR>
  20. Click on the picture to see CGX V3 with SUPERLAYERS and Birdie on Drugs!
  21. </CENTER>
  22. <HR>
  23. <H2><B>Birdie Files</B></H2>
  24. <CENTER>
  25. <TABLE CELLSPACING=0 BORDER=1 WIDTH=90%>
  26. <TR>
  27. <TD>October 8, 1997</TD>
  28.  
  29. <TD> <B>Birdie 1.3</B> </TD>
  30.  
  31. <TD>
  32. WWW - <A href="http://www.vgr.com/birdie/Birdie13.lha">Birdie13.lha</A><BR>
  33. FTP - <A href="ftp://ftp.vgr.com/Birdie13.lha">Birdie13.lha</A>
  34. </TD>
  35.  
  36. </TR>
  37. </TABLE>
  38.  
  39. <BR>
  40. <B>Birdie</B> is copyright ©1997 by Trond Werner Hansen.<BR>
  41. CyberGraphX V3 ©1996-1997 phase5 Digital Products.<BR>
  42. </CENTER>
  43.  
  44. <HR>
  45. <H2><B>Read This</B></H2>
  46. <PRE>
  47.  
  48.  
  49. Birdie 1.2 © 1997 Trond Werner Hansen (Tronan).
  50.  
  51. Email: tronhan@stud.ntnu.no
  52.  
  53. Birdie is a *hack* which gives you patterns in the windowborders
  54. of windows on the workbench screen.
  55.  
  56. NOTE: this archive contains some example patterns, which probably
  57. are copyrighted by someone. 
  58.  
  59. NOTE2: this hack is designed for gfxcard owners, and although
  60. version 1.3 works with AGA/ECS, keep in mind that I won't spend
  61. time tuning if for such setups..
  62.  
  63. IMPORTANT:
  64. While birdie is running, the default public screen (Workbench)
  65. which it affects, will be locked. To change screenmode,
  66. you must first CTRL-C break it. But you should not break
  67. it if other hacks have patched your system after Birdie.
  68. Therefore you should run Birdie last in your startup. 
  69.  
  70. Remember to disable patches like QuickDraw, Centertitles and similiar
  71. stuff.
  72.  
  73. Usage
  74. -----
  75.  
  76. "Birdie ?" gives:
  77.  
  78. "ACTIVEPATTERN/S,PATTERNS/M,NODRAW/S,NOBITMAPS/S,NOICONBORDER/S,NOLIGHTING/S,
  79. ACTIVECOLOR/K,IMPOSELEVEL/N,LRA/N,LGA/N,LBA/N,DRA/N,DGA/N,DBA/N,PRECISION/N"
  80.  
  81. PATTERNS
  82. --------
  83. From 1 to 20 names of patterns. If none are given or birdie
  84. is unable to load none for some reason, birdie simply returns, doing 
  85. nothing. When running, each window will get a random pattern from this
  86. list. The patterns are loaded using datatypes.
  87.  
  88. example: "Birdie pattern1.iff pattern2.iff"
  89.  
  90. ACTIVEPATTERN
  91. -------------
  92. This switch tells birdie that the first pattern
  93. in the list (see above), should be used as active window pattern.
  94. When windows are inactive they will get a random one from the
  95. REST of the list. This switch makes no sense unless you give birdie
  96. at least 2 patterns.
  97.  
  98. example "Birdie pattern1.iff pattern2.iff pattern3.iff ACTIVEPATTERN"
  99.  
  100. In this example, "pattern1.iff" will be used for the active window,
  101. while when inactive each window will get either "pattern2.iff" or
  102. "pattern3.iff" (selected random, when window is opened).
  103.  
  104. NODRAW
  105. ------
  106. This switch disables the Draw() patch in gfx.lib. Meant for
  107. debugging purpose.
  108.  
  109. NOBITMAPS
  110. ---------
  111. No bitmaps rendered to the window border will be patched.
  112. This usually means that system gadgets will be left alone.
  113.  
  114. NOICONBORDER
  115. ------------
  116. This switch is for users of the original Workbench. Icons
  117. will be rendered without border and have pen 0 transparent.
  118. The iconbitmaps and masks are cached after first draw, which
  119. means it will refresh faster, but it also eats memory.
  120.  
  121. Use this option instead of the NewIcons one. Also, disable
  122. QuickDraw in MCP.
  123.  
  124. NOTE: For this switch to work, you must NOT use the NODRAW
  125. or NOBITMAPS.
  126.  
  127. PRECISION
  128. ---------
  129. This is a number from 32 to -1 meant for AGA users to specify
  130. the remap precision, so that they can save some pen allocations.
  131. Default is -1, which gives best precision (EXACT).
  132.  
  133. example: "birdie pattern1.iff PRECISION=32" (very low precision)
  134.  
  135. *********************************************************************
  136. * the following options only make sense for users of
  137. * hi/truecolor screens. (ie. Gfxcards)
  138. *********************************************************************
  139.  
  140. NOLIGHTING
  141. ----------
  142. This switch causes users of hi/truecolor displays to not have
  143. the real shine/shadow effect, but get the old white/black lines.
  144. Will save you some memory.
  145.  
  146. ACTIVECOLOR
  147. -----------
  148. Instead of using ATCIVEPATTERN switch to get a seperate pattern
  149. for the active window, you can instead make the window get
  150. the same pattern as used when inactive, but imposed with a
  151. a special color. The color is given as a hexnumber in RGB format,
  152. 8bits per gun. See example.
  153.  
  154. example: "birdie Patterns1.iff ACTIVECOLOR=ff0000"
  155.  
  156. This imposes color Red (ff0000) to the active window.
  157.  
  158. NOTE: this uses even more memory, twice as much in fact.
  159.  
  160. IMPOSELEVEL
  161. -----------
  162. If you use the ACTIVECOLOR option, you can use IMPOSELEVEL
  163. to set how much in % the color should be imposed. Default
  164. is 50%.
  165.  
  166. example: "birdie pattern1.iff ACTIVECOLOR=ffff00 IMPOSELEVEL=20"
  167. this will impose the active pattern by yellow, 20%.
  168.  
  169. LRA,LGA,LBA,DRA,DGA,DBA
  170. -----------------------
  171. Each of these options is given with a number which is the 
  172. RGB balance value used for generating the shine/shadow effect
  173. in high/truecolor.
  174.  
  175. DEFAULT is, shine: 60,60,60 shadow: -60,-60,-60
  176.  
  177. example: "Birdie pattern1.iff LRA 100 LGA 80 LBA 60 DRA -60
  178. DGA -80 DBA -100"
  179.  
  180. This will give the shine version of the pattern a balance of
  181. 100,80 and 60, which means 100 will be added to the RED gun
  182. of each pixel, 80 to the GREEN and 60 to the BLUE.
  183. For the shadow version I use negative numbers so that the
  184. RGB values get lower (darker pixel). Each gun i 8bit (0-255).
  185.  
  186. If you don't get it, try and you'll soon figure it out.
  187.  
  188. ******
  189.  
  190.  
  191. Birdie mini FAQ.
  192.  
  193. What is Birdie?
  194. ---------------
  195. Birdie is a hack that gives you datatypes loaded patterns in the window
  196. border of windows open on the default public screen (WB). Current version
  197. is V1.3.
  198.  
  199. Where can I get it?
  200. -------------------
  201. www.vgr.com/birdie
  202.  
  203. How does it work?
  204. -----------------
  205. It redirects border rendering calls to own fast pattern fill routines.
  206. If the screen is hicolor, also shine and shadow pens (white and black)
  207. will be replaced with a shine and shadow versions of the pattern. This
  208. light effect is currently precalc'ed, so each pattern is stored
  209. in 3 versions, eating up memory if big patterns are used. In 8bit
  210. only the normal fill color is changed. In 1.2 you can control how
  211. it works somewhat more.
  212.  
  213. Is birdie safe to use? Will it crash?
  214. -------------------------------------
  215. Maybe. You just have to try it. There ARE problems, but many people
  216. including myself don't have any of them. This makes it difficult for
  217. me to debug it, but I'm doing my best to try to figure out what is
  218. wrong.
  219.  
  220. It doesn't work here, is there anything I can do?
  221. ------------------------------------------------
  222. Maybe. First try disabling ALL hacks and patches. Try to break
  223. your startup right after IPrefs is loaded. Then start birdie, and see
  224. if it works. If it does, you could try to nail down what other thing is
  225. causing Birdie to crash by reenabling other hacks. If you discover
  226. something neat, please mail me. (see address below)
  227.  
  228. Are there any known problems with other hacks?
  229. ----------------------------------------------
  230. I haven't actually verified all of this, but people have mentioned
  231. the following:
  232. - disable PatchControl. At least for testing Birdie once.
  233. - check if you're using a weird adddatetypes replacement.
  234. (I doubt this means anything, but you never know).
  235. - disable Arq if you use it and try.
  236. - try running StackAttack and give all tasks some more stack.
  237.  
  238. again, if you somehow can verify anything, please mail me.
  239.  
  240. Birdie disables the NoBorder hack in NewIcons. What's up?
  241. ---------------------------------------------------------
  242. Patch conflict, caused by NI being more dirty than it needs
  243. to. I'm gonna do my own NoBorder patch within Birdie, so that
  244. people don't have to run patch on patch on patch... It will
  245. be faster too, I hope :)
  246.  
  247. NOTE: in 1.2 birdie has a new NOICONBORDER option which you
  248. should use instead of the NI options.
  249.  
  250. Does Birdie make my system slower?
  251. ----------------------------------
  252. Yes. But only by a tiny amount. You will probably never see it
  253. yourself, but if you run WSpeed or similiar progs, you can
  254. discover a tiny slowdown, at least in the Draw Hor/Vert 
  255. test I think. 
  256.  
  257. DON'T be scared by this. In fact, for Gfxcard owners,
  258. Birdie can actually make your border draw
  259. faster!!! How that is possible? You see, the system gadgets
  260. are normally in planar mode, and even when running sysihack
  261. they are planar. Technically, this is due to that
  262. when BOOPSI images are created, they get a DrawInfo
  263. structure to peek at for rendering info. But this 
  264. structure was designed for planar AOS displays
  265. and does not contain a bitmap pointer or any other source of
  266. info so that the BOOPSI class can tell what custom CGX
  267. pixelformat the screen is. Therefore, such images
  268. ends up being planar. This means that everytime intuition
  269. redraws a border, all the system gadgets must be converted
  270. from, say, 8bit planar to 16bit hicolor, which is VERY
  271. SLOW. With birdie, a pattern filled copy of the image
  272. is quickly drawn because it is in hicolor already!
  273.  
  274. Any last words?
  275. ---------------
  276. Well, Birdie was developed with the aid of chocolate. Author
  277. is Trond Werner Hansen, tronhan@stud.ntnu.no 
  278. It was made just for fun and for all cgx users to enjoy.
  279.  
  280. ******
  281.  
  282.  
  283. version 1.3 (8.oct.97)
  284. ----------------------
  285. Birdie no longer needs CGX/Superlayers.
  286. Added PRECISION and IMPOSELEVEL.
  287. ACTIVECOLOR now works with all hi/truecolor pixelformats.
  288.  
  289. version 1.2 (6.oct.97)
  290. ----------------------
  291. Added NOLIGHTING,NOICONBORDER,ACTIVECOLOR,LRA,LGA,LBA,DRA,DGA,DBA.
  292. Rewrote bitmap stuff.
  293. Baked a chococake (not included in archive).
  294.  
  295. version 1.1
  296. -----------
  297. Added proper DrawInfo usage.
  298. Added NOBITMAPS switch.
  299. Fixed problems with dual-layered GZZ windows.
  300.  
  301. version 1.0
  302. -----------
  303. First public release. 95% rewrite.
  304.  
  305. version -13 (jan/feb 97)
  306. ------------------------
  307. internal weird-thing (tm).
  308.  
  309.  
  310.  
  311.  
  312. </PRE>
  313. <HR>
  314. <font size=1>
  315. <CENTER>
  316. As of August 30th, 1997 this is the 4,048th hit to this page.
  317. If you have any questions you can email <A HREF="mailto:tronhan@stud.ntnu.no">Trond</A> ©1997 Trond Werner Hansen
  318. </font>
  319.  
  320. </CENTER>
  321. </BODY> </HTML>
  322.